home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / ZIPPED / DOS / HOME / APPT101.ZIP / APPT.DOC < prev    next >
Text File  |  1992-11-12  |  34KB  |  826 lines
  1.  
  2.  
  3.                       
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                -----------------------
  11.                    A P P T
  12.                -----------------------
  13.  
  14.                   Appointment Minder
  15.                 Version  1.01
  16.  
  17.  
  18.  
  19.                       
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.              APPT Program Documentation
  30.                  11/12/1992
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                    James Corpening
  44.                  GymusWhere?
  45.                   828 NW 79 Terrace
  46.                 Plantation, FL  33324
  47.  
  48.  
  49.  
  50.               Copyright 1992 by James Corpening
  51.                  All rights reserved
  52.  
  53.                        
  54.                       
  55.                       
  56.  
  57.                    C O N T E N T S
  58.  
  59. Preliminary Information.................................................. 3
  60.   Quick Set-up
  61.   The Package
  62.   Registration
  63.  
  64. Legalities............................................................... 5
  65.   Copyright Information
  66.   License Information
  67.   Disclaimer
  68.  
  69. Shareware................................................................ 6
  70.  
  71. Introduction............................................................. 7
  72.  
  73. System Requirements...................................................... 8
  74.  
  75. Understanding and Using APPT............................................. 8
  76.   Viewing Window
  77.   Editing Window
  78.   No-Data Window
  79.  
  80. Additional Information...................................................11
  81.   DataFile Format
  82.   Errors
  83.  
  84. Registration Form........................................................15
  85.  
  86.  
  87.  
  88.  
  89.  
  90.                     
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.                       
  103.  
  104.                APPT Appointment Minder
  105.               Copyright 1992 by James Corpening
  106.                  All rights reserved
  107.                
  108.  
  109.  
  110.                     - 2 -
  111.  
  112.         P R E L I M I N A R Y   I N F O R M A T I O N
  113.                 
  114.               ----------Quick Set-up----------
  115.  
  116. This explains how to get APPT Appointment Minder up and running--quickly.  
  117. If you have read the README.1ST file, you are already in-gear.  Nevertheless, 
  118. you should read the remainder of APPT.DOC to fully understand APPT.  
  119.  
  120. Put APPT.COM in your root directory, type APPT and press [Enter].  Assuming
  121. that you've not created the data file APPT.DAT, you will receive an error:
  122.  
  123. ** ERROR **
  124. Please refer to APPT.DOC for clarification of the following:
  125. Error Opening Data File--Cannot find appointments
  126.  
  127. Press any key to exit...
  128.  
  129. Press any key.  Again, type APPT [Enter] and you will meet APPT Appointment 
  130. Minder.  APPT has created an empty data file entitled APPT.DAT.  You have, 
  131. however, no appointments.  Press [F5] to start the APPTEDIT, the internal 
  132. editor.  Now enter today's date in MM-DD format.  Be sure to place the date 
  133. in the first five positions on the line--THIS IS ESSENTIAL.  Go ahead and 
  134. type a bit more after the date.  If you wish to play, enter some text on the 
  135. lines above today's date; this will show you how APPT works.
  136.  
  137. Now save your data file by pressing [F9].  When the checkmark appears beside
  138. [F9], press [Esc] to exit APPTEDIT, then [F10] to exit APPT.  Now you are 
  139. ready to run APPT again and see APPT work.  Have fun.
  140.  
  141.  
  142.                ----------The Package----------
  143.  
  144. APPT Appointment Minder is an easy-to-use appointment reminder program that
  145. retrieves your appointments from a standard text-file, starting with the 
  146. first occurrence of today's date.  APPT is most useful when run from your 
  147. AUTOEXEC.BAT file at system start-up, thereby offering you an almost hands-off
  148. method of maintaining your daily schedule.
  149.  
  150. The APPT Appointment Minder package includes the following files:
  151.  
  152. Filename:        Size:     Date:        Description:
  153.  
  154. APPT.COM         6,077     11/12/92     APPT Appointment Minder 1.01   
  155. APPT.DOC        33,718     11/12/92     APPT operation manual
  156. APPTREAD.ME      1,377     11/12/92     Quick set-up guide
  157. APPT.SMP           475     11/12/92     Sample data file
  158. CURSOR.COM          11     11/12/92     Replaces cursor after APPT abort
  159. APPT.REG         1,522     11/12/92     APPT Registration Form
  160. APPT-REG.BAT        27     11/12/92     Batch file to print APPT.REG    
  161. APPT-DOC.BAT        27     11/12/92     Batch file to print APPT.DOC
  162. FILE_ID.DIZ        238     11/12/92     Description file
  163. DESC.SDI           238     11/12/92     Description file
  164.                     
  165.                     - 3 -
  166.  
  167. If your package lacks any of these files, you should try to obtain the 
  168. complete package.  If that is not possible, I hope that you have at least
  169. the following:  APPT.COM, APPT.DOC, and APPT.SMP.  Those three files will
  170. suffice in allowing you to productively use APPT.
  171.  
  172.  
  173.                ----------Registration----------
  174.  
  175. Registration of APPT is very easy and inexpensive.  As you receive it, APPT
  176. is completely functional.  The only difference between unregistered and 
  177. registered versions of APPT is the inclusion of shareware information in the 
  178. unregistered version.  After registration, you will receive instructions to 
  179. disable the shareware labeling.
  180.  
  181. Registration is only $10.  
  182.  
  183. Please complete the registration form located at the end of this manual 
  184. (or print the registration form as you exit APPT) and send a money order or 
  185. check (US funds, US bank), payable to James Corpening, to:
  186.  
  187.     James Corpening
  188.     GymusWhere?
  189.     828 NW 79 Terrace
  190.     Plantation, FL  33324-1466
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                     
  203.                     
  204.                     
  205.                     
  206.                     
  207.                     
  208.                     
  209.                     
  210.                     
  211.                     
  212.                     
  213.                     
  214.                     
  215.                     
  216.                     
  217.                     
  218.                     
  219.                     
  220.                     - 4 -
  221.  
  222.                  L E G A L I T I E S
  223.  
  224.           ----------Copyright Information----------
  225.  
  226. United States Copyright Law is intended to protect authors from unauthorized 
  227. use of their work.  APPT Appointment Minder is copyrighted by James Corpening 
  228. and GymusWhere?  That means that APPT.COM and APPT.DOC belong to James 
  229. Corpening, and are protected under United States Copyright Law and the 
  230. agreements of the Berne Convention.  You may legally make NO modifications 
  231. to APPT.COM nor to APPT.DOC.  Furthermore, you may use APPT Appointment 
  232. Minder only under the conditions of the following license.
  233.                    
  234.            ----------License Information----------
  235.  
  236. As an end-user, you are granted a license to evaluate APPT Appointment Minder 
  237. for 28 days.  After 28 days, if you decide to continue using APPT, you must 
  238. register your copy.  If, however, you decide that APPT can not serve you well, 
  239. you must discontinue use.  Once registered, you gain the privilege of using 
  240. APPT through version 2.99.  The per-copy registration fee registers only one 
  241. copy of APPT, meaning that you may place and use said copy of APPT on any 
  242. computer as long as it does not simultaneously reside on another computer.  
  243. You must register one copy of APPT for each computer on which APPT will reside.
  244. Registered or unregistered, you may distribute ONLY the complete, unmodified 
  245. shareware package.  This license also allows you to duplicate the APPT package,
  246. as described above, for archival or distribution purposes only.  If you can 
  247. not agree to the conditions set forth in this license, please do not use APPT.  
  248.  
  249. Unregistered use of APPT beyond 28 days violates this license and United 
  250. States Copyright Law [17 USCA Section 102 et seq.], and subjects you 
  251. (individual or company) to severe criminal liability.  
  252.  
  253. Registration fees and distribution fees are distinctly different.  The APPT
  254. package may be sold only by GymusWhere? and James Corpening.  If you paid
  255. someone other than James Corpening or GymusWhere? for APPT Appointment
  256. Minder, you paid for the distribution only--not registration.  Sale of this
  257. software by any other individual or company is illegal.  This software may,
  258. however, be distributed by parties other than GymusWhere? or James Corpening, 
  259. in which case only the complete, unadulterated shareware package may be 
  260. distributed.  If distribution fees are charged for this package, the 
  261. distributor must first procure written consent from James Corpening; 
  262. thereafter, said fees may not exceed five dollars ($5.00), and are limited 
  263. to charges for distribution and/or diskette only.  
  264.  
  265. APPT is a very helpful tool that may be best used in a business environment.
  266. If you wish to discuss registering many copies of APPT, or gaining a site 
  267. license, please feel free to contact me at any one of the addresses below.
  268.                    
  269.                ----------Disclaimer----------
  270.  
  271. APPT Appointment Minder and related files/programs are accompanied by no
  272. warranty, explicit or implicit.  Neither GymusWhere? nor James Corpening
  273.                     
  274.  
  275.                     - 5 -
  276.  
  277. may be held responsible for missed appointments, lost data, lost profits,
  278. or any damages resulting from the use of APPT Appointment Minder and
  279. related files/programs.  Careful effort has been made to produce a quality
  280. product.  Nevertheless, hardware, software, and user variability cannot be
  281. totally accounted for.  Every user should, therefore, thoroughly test this
  282. package with non-important data.  SELLER LIABILITY IS LIMITED TO REFUND OR
  283. PRODUCT-REPLACEMENT.
  284.                   
  285.                   S H A R E W A R E
  286.  
  287. The shareware approach to software marketing is a great concept that, if
  288. adhered to, benefits both endusers and programmers.  Shareware products are
  289. programs of quality, no less than retail-marketed products.  In fact, many 
  290. retail-marketed software products were born as shareware.  The success of 
  291. shareware is dependent on the good nature of its users.  
  292.  
  293. The strategy is simple.  Shareware packages are distributed to the public via 
  294. distribution houses (which charge for the distribution only), by user groups, 
  295. or by electronic routes (e.g., BBSs).  As a user, you are encouraged to use 
  296. these programs on an evaluation basis.  After a period of a few weeks, you can
  297. have a good idea of the usefulness of a package.  If you are satisfied with
  298. the package, and wish to continue using it, you are expected to purchase your 
  299. copy.  If you find that the software does not meet your needs, you are not
  300. expected to purchase it, but you are expected to cease using the it.
  301.  
  302. This approach to software evaluation is often referred to as "test-drive,"
  303. and appropriately so.  Evaluating software prior to purchase is tantamount
  304. to test-driving an automobile prior to purchase.  If you like it, you buy it.  
  305. If you decide that the automobile does not fit your needs, you return it.
  306.  
  307. Another fantastic benefit to shareware packages is the price.  Distributing
  308. shareware is less expensive than mass-producing and marketing a product in
  309. the conventional manner.  The overhead is low, and the principle investment
  310. is time (not pretty packaging, advertising, nor paid vacations for the guys
  311. upstairs).  This allows shareware authors to often offer their product at
  312. very attractive prices.  But even if price were not an issue, it is very
  313. convenient to be able to test software prior to purchase.
  314.  
  315. Regardless of the stage of your evaluation, you are encouraged to
  316. distribute the shareware package as you received it.  This gives you an
  317. opportunity to offer your opinions of the software and, if fitting, fulfill
  318. any upload obligations you may have with your BBS.
  319.  
  320. Quite frequently, lack of shareware registration is simply a matter of
  321. procrastination.  A user puts the program(s) on her/his machine and finds
  322. it very useful.  Because the program is installed, however, there is a
  323. tendency to overlook registration.  To prevent this neglect, some shareware
  324. authors release versions that are crippled (not fully functional).  APPT
  325. Appointment Minder is fully functional in its shareware package.  I've
  326. decided to trust you as a user, and I hope that you appreciate such trust.
  327.                     
  328.                     
  329.                     
  330.                     - 6 -
  331.  
  332.                I N T R O D U C T I O N 
  333.  
  334. GREAT!  Another appointment reminder program.  
  335.  
  336. OK, I admit, these things typically are more of a burden than they are
  337. worth.  By the time I turn on my system and run the program, I have had
  338. plenty of time to plan my day from the Post-It Notes that litter my desk. 
  339. What I really need is a (relatively) hands-off approach to planning my day.
  340. Well, here it is.  APPT offers several benefits that make it a better 
  341. appointment minder.  
  342.  
  343. -APPT is intended to be run automatically from your AUTOEXEC.BAT file (you
  344. may, of course, run APPT manually from command line).  Unlike appointment
  345. reminders that need you to tell them what to do, APPT knows what to do.  When
  346. you call APPT, you are shown today's appointments--effortlessly.  There is no
  347. need to navigate through an outdated appointment list.  The only preparation
  348. on your part, then, is to add appointments to your data file (sorry, but
  349. APPT can not log your appointments, but it can help--see below).
  350.  
  351. -APPT doesn't bother you with yesterday's appointments; APPT searches your
  352. data file and retrieves only today's and future appointments.  APPT then
  353. automatically updates your data file by removing past appointments.  These
  354. appointments are moved to a back-up file where they may be accessed with
  355. any text-editor, or read with DOS' TYPE command.  
  356.  
  357. -Because APPT retrieves appointments from a separate data file, the data
  358. file may be updated on any remote terminal, and subsequently transferred to
  359. all linked terminals, including APPT's.  This is ideal in situations in
  360. which somebody else logs your appointments, but you wish to view them with
  361. APPT on your own terminal.
  362.  
  363. -APPT displays one window of appointments, and only one key-press advances
  364. your viewing window.  Another key-press backs-up your viewing window to the
  365. previous data.  This convenience allows you to move easily through your
  366. appointments.
  367.  
  368. -With APPT, one key-press prints appointments from the current window.  A
  369. special Formfeed option signals your printer to feed the remainder of your
  370. print job when appointments do not fill the entire page.  
  371.  
  372. -APPT's help screen is one key-press away from you at any time.  Although
  373. APPT is easy enough that the help screen will be seldom used, it is there
  374. if you need it.
  375.  
  376. -APPT has an internal editor, APPTEDIT, that allows you to easily edit your
  377. appointment file.  Once saved, edits are immediately available in APPT's
  378. viewing window.
  379.  
  380. -APPT is written entirely in assembly language--the next best thing to
  381. "machine talk."  This allows APPT to use little memory, and to be very
  382. small and very fast.
  383.  
  384.  
  385.                     - 7 -
  386.  
  387. -APPT is a very convenient and useful utility.  APPT is also inexpensive, a
  388. bargain.  Although registering your copy of APPT will entitle you to other
  389. benefits, it is quite satisfying to know that you play a major role in
  390. strengthening shareware as a marketing tool.  Besides, paying for
  391. merchandise is truly conventional.
  392.  
  393.             
  394.             
  395.             S Y S T E M   R E Q U I R E M E N T S
  396.  
  397. APPT: 
  398. -Requires DOS version 2.0 or higher.
  399. -Requires at least an 8086-based IBM-compatible computer.
  400. -Requires approximately 6K of conventional RAM for the program proper. 
  401.  APPT establishes buffers to store appointment data and editing data, so 
  402.  the total conventional memory requirement approximates 38K.
  403. -Requires a Color Graphics Adapter (CGA) or better.  APPT will not work
  404.  with a Monochrome Display Adapter (MDA).
  405. -Requires a text-mode display of 80 columns by 25 rows, in either color or
  406.  b/w, to conform to program expectations.  The present version of APPT does
  407.  not check the number of rows/columns of your monitor.  Other video modes
  408.  may work, but the displays will be undefined.  Preferred video modes are 
  409.  #2 (b/w) and #3 (color).
  410.                     
  411.  
  412.       U N D E R S T A N D I N G   &   U S I N G   A P P T
  413.  
  414. Although I find tutorials notoriously tedious, the following is a short
  415. run-through of APPT's operation, mixed with explanation.  APPT is very easy
  416. to use; you can get very comfortable with APPT by just fumbling through it.  
  417. Nevertheless, I am obligated to provide detailed explanation.  I suggest that 
  418. you at least skim this to get the basics, lest you have questions later.
  419.  
  420. Throughout the text you will find references to several files.  APPT refers
  421. to the main program APPT.COM, APPT.DAT is the data file to contain your
  422. appointments, and APPT.BAK is the backup data file format.  APPTEDIT refers
  423. to APPT's internal editor, but it is not a separate file.
  424.  
  425. APPT Appointment Minder does just that--minds your appointments.  APPT is
  426. executed when you issue the command APPT.  APPT displays a logo at the top
  427. of your screen, a menu bar at the bottom of your screen (assuming that your
  428. screen is 25 rows by 80 columns; I'm not convinced that enough people use
  429. 80x50 to make it worthwhile to adjust for such--maybe I'll learn different.), 
  430. and appointments between the logo and menu bar.  The logo includes APPT's 
  431. name and version number, and today's date, as reported by your system, in 
  432. MM-DD format.  The menu bar displays the options available to you, and those
  433. options will change according to where you are in APPT.  
  434.  
  435. Upon start-up, APPT searches for appointments in the data file APPT.DAT;
  436. APPT.DAT should exist before running APPT.  You may use any text-editor or
  437. word-processor to create APPT.DAT; you must, however, place dates on the
  438.  
  439.               
  440.                     - 8 -
  441.  
  442. first five positions on a line, in MM-DD format.  You must also save the
  443. data file in TEXT ONLY format, void of application-specific formatting
  444. (special characters, bold, italics, etc.).  If APPT does not find the
  445. proper data file, APPT will notify you that it can not open the data file,
  446. but it will create an empty APPT.DAT for you to edit.  It is then up to you
  447. to add your appointments to the data file.  
  448.  
  449. If you run APPT without first creating APPT.DAT, and APPT creates the empty
  450. data file, you may then run APPT again to modify the data file with
  451. APPTEDIT.  When you run APPT for this second time, you will receive a No
  452. Appointments Today notice because the data file is empty.  You will also
  453. see that the menu bar displays three (3) command options: 
  454.  
  455.     [F1]  Help              [F5]  Edit              [F10]  Quit.  
  456.  
  457. [F1] and [F10] really need no explanation.  Choosing [F5], however, will
  458. open APPTEDIT.  A note is in order here.  Only in APPTEDIT will a cursor
  459. represent an insertion point.  You should see no cursor if you are not in
  460. APPTEDIT.  If you do see a cursor, that is just a quirk--it will not
  461. represent an insertion point.
  462.  
  463. Once you open APPTEDIT, the menu bar will quickly change to display the
  464. editing options (also, it should turn red) and the cursor will appear.  In 
  465. the upper left corner of the Logo bar the word Editing will blink.  You may
  466. now enter appointments using generic text-editing commands (text keys,
  467. [Ins], [Tab], etc.).  When you wish to save your edits, press [F9] and
  468. APPTEDIT will save APPT.DAT to disk.  At this point a checkmark should
  469. appear in the menu bar to the left of [F9].  This signals that the save is
  470. completed (the checkmark will vanish at the next key pressed).  Keep in mind
  471. that this editor is designed to work only from within APPT, and only on
  472. APPT.DAT; it is not a full word-processor, and is included as a convenience
  473. for you, the user.  In other words, don't expect it to work miracles.  
  474.  
  475. Now exit APPTEDIT by pressing [Esc]; you are now in the viewing window. 
  476. The menu bar will once again change to display the options available to
  477. you.  You can see that your edits are immediately available.  You will
  478. probably use APPT mostly from this viewing window.  
  479.  
  480. Although the Help Screen is available from any window by toggling [F1], the
  481. explanations are very succinct.  Below are more thorough explanations of
  482. APPT's commands.  
  483.  
  484.  
  485.            ----------Viewing-Window Keys----------
  486.  
  487. [PgUp]        Displays the previous window in your data file, assuming that    
  488. you advanced with the [PgDn] Command.
  489.  
  490. [PgDn]        Displays the next window in your data file if the data exceed
  491. 14 lines (14 lines is the size of the data window).  APPT makes room for
  492. 10 totally full (14 rows x 80 columns) windows of data, but allows that 
  493. amount of data to be displayed across (15) windows.
  494.  
  495.                     - 9 -
  496.  
  497. [F1] Help     Displays the Quick-Help Screen that briefly explains the
  498. commands available in the menu bar.  Press [F1] again to exit Help.  
  499.  
  500. [F3] Print    Sends the data in the display window to your printer.  The
  501. window data, however, will not fill an entire sheet, and your printer will
  502. not feed the complete sheet until the sheet is full.  This allows you to
  503. advance the data window with [PgDn] and include more than one window on
  504. each sheet.
  505.  
  506. [F5] Edit     Initiates APPT's internal text editor, in which you can edit
  507. APPT.DAT.  This editor is not a full word-processor, so you are limited in
  508. what you can accomplish with it--it is included as a convenience for
  509. creating/modifying your appointment file.  The text editor is explained
  510. more fully elsewhere in this manual.
  511.  
  512. [F7] Formfeed Advances the paper in your printer by one sheet.  When you
  513. have finished sending appointments to your printer, the sheet will most
  514. likely have yet to feed (a laser printer holds the sheet until it is
  515. completely full, a dot-matrix printer will feed only as much as has
  516. printed).  You should then complete the print job by pressing the formfeed
  517. key, thereby advancing the paper.  Because the window displays 14 lines of
  518. data, and because APPT uses two lines per sheet for a header, you probably
  519. can send 4 windows of appointments onto one sheet of paper (14 x 4 + 2 = 58
  520. lines) before having to advance the sheet.  
  521.  
  522. [F10] Quit    Exits APPT and returns you to DOS.
  523.  
  524. [Alt][R]      Refreshes the screen if corrupted.  In the event that DOS
  525. invades the screen (e.g., the infamous Abort, Retry, Ignore, Fail?), you
  526. may clean the display by holding the [Alt] key depressed and then pressing
  527. the [R] key (case is inconsequential).  For example, APPT will not trap
  528. printer-related errors; that task is left to DOS.  If you press [F3] or
  529. [F7] when your printer is not on-line or not powered on, DOS' print-error
  530. message will invade the APPT display (probably in the lower left corner). 
  531. You may then correct the printer situation, press r (retry), and then
  532. [Alt][R] to refresh the screen.  This service is purely for appearance; if
  533. DOS does send a message to the screen, APPT should continue to function 
  534. correctly.
  535.  
  536.  
  537.         ----------Editing-Window Keys----------
  538.  
  539. [PgUp/Dn]     Move the editing cursor up/down one window.
  540.  
  541. [F1]                Displays the Help Screen.
  542.  
  543. [F9]          Saves your edits to disk.  A checkmark will appear to the
  544. left of the [F9] to signal the completed save.  This checkmark will vanish
  545. at the next key-press.
  546.  
  547. [Home],[End]  Move the cursor to the start or end, respectively, of the
  548. present line.
  549.  
  550.                    - 10 -
  551.  
  552. [Esc]         Exits APPTEDIT and returns you to the viewing window.  You
  553. must be sure to save your most recent edits--APPT will not warn you of
  554. unsaved changes to your data file.
  555.  
  556. Edit Keys     Standard editing keys include text characters, tab, backspace, 
  557. enter, delete, insert, cursor arrows.
  558.  
  559.  
  560.            ----------No-Data-Window Keys----------
  561.  
  562. These keys, [F1], [F5], [F10], are described above.
  563.  
  564.  
  565.  
  566.           A D D I T I O N A L   I N F O R M A T I O N
  567.  
  568. Some of the following information is redundant, but helps elucidate
  569. additional characteristics of APPT.
  570.  
  571. As mentioned above, when APPT is working, you may see no cursor.  The
  572. cursor will re-appear, however, when you exit APPT.  APPT will not trap
  573. printer-related errors; that task is left to DOS.  If DOS does trap such an
  574. error, and if you choose to abort rather than retry the print, APPT will
  575. not be able to return the cursor to screen.  Rather than expect you to then
  576. recall APPT or re-boot your computer to retrieve your cursor, I have
  577. included a small file entitled CURSOR.COM to easily bring back your cursor.
  578.  
  579. When the help screen is displayed, pressing any key other than [Esc] has no
  580. effect.  Generally, the same applies to the appointment screen.  There is,
  581. however, an exception.  Pressing an unassigned function key (F1-12) or
  582. auxilliary keys (e.g., arrows) will return a beep.  This may be quite 
  583. annoying, but given the nature of the print option (specifically when used 
  584. with laser printers), it may not be readily obvious that your data made it to 
  585. the printer.  The alerting beep informs you when you missed the correct key.
  586.  
  587. APPT.DAT must reside in the same subdirectory as APPT.  If APPT creates the
  588. data file, you will find APPT.DAT within the same subdirectory.
  589.  
  590.  
  591.             ----------Data File Format----------
  592.  
  593. Although strict, there is some variability in the date format that APPT will
  594. correctly recognize.  For example, each of the following formats will work:
  595.  
  596.          MM-DD(-YYYY)           MM.DD(.YYYY)
  597.          MM/DD(/YYYY)           MM DD( YYYY)
  598.  
  599. Essentially, you may separate MM and DD with any character.  MM, however,
  600. must occupy the first and second positions on the line, and DD must occupy
  601. the fourth and fifth positions.  MM must be FAR LEFT--no space between the
  602.                    
  603.                    
  604.  
  605.                    - 11 -
  606.  
  607. left margin and the date!  THIS IS VERY IMPORTANT.  Anything after DD is
  608. entirely optional; APPT evaluates only the first five characters on each
  609. line.  The file APPT.SMP is included with this package as a sample data
  610. file for your reference.  
  611.  
  612. This strategy to text-searching may appear awkward.  I considered just
  613. performing a string search that would allow the date to be anywhere on a
  614. line.  This, however, would mean that _any_ dates logged in the text would
  615. be fair game to APPT.  For example, consider the following entry:
  616.  
  617.     11/23   Phone Baker regarding 11/26 lunch.
  618.  
  619. That would work well on 11/23, but assuming that APPT was not used between 
  620. the 23rd and the 26th, the first line to be displayed on 11/26 would be:
  621.  
  622.     11/26   lunch.
  623.  
  624. In this case, you may be happy with the brief reminder (if you could remember
  625. Baker).  I felt, however, that the potential for confusion was too great, so 
  626. I opted for the present strategy.  
  627.  
  628. If APPT finds today's date in your data file, it will display appointments
  629. starting with the first instance of today's date, including all
  630. appointments that follow.  APPT will NOT display past appointments (unless
  631. they are listed after today's date).  Also, it will NOT display ANY
  632. appointments if it does not find today's date in APPT.DAT (i.e., APPT.DAT
  633. may contain 100 appointments for tomorrow, but if it contains none for
  634. today you will receive a notice of no appointments).  So, if you wish to be
  635. shown tomorrow's appointments today, include a line with today's date.
  636.  
  637. APPT is a convenient utility, but is simple-minded.  APPT searches your data
  638. file for today's date, discarding old data.  Once APPT finds today's date,
  639. it does no more searching.  Depending on how many appointments I have on a
  640. given day, I find that constructing my data file so that only one day's
  641. appointments occupy each window allows a less cluttered display and allows
  642. me to print only one date's appointments.  Remember, however, that APPT
  643. only grants you access to 15 windows of data.  Constructing a data file that 
  644. is smaller than 11,200 bytes, but that extends beyond 15 windows will mean 
  645. that you have access to only the first 15 windows.  I strongly suggest that 
  646. you avoid files larger than 11,200 bytes.  
  647.  
  648. Every time that APPT finds today's date in APPT.DAT, the data file will be
  649. renamed APPT.BAK.  A new APPT.DAT will then be created containing today's
  650. and future appointments.  This avoids showing you old appointments, yet
  651. allows you opportunity to recall old appointments by viewing APPT.BAK with
  652. another text-editor or with DOS' TYPE command, but ONLY until you reexecute
  653. APPT.  If there are no appointments for the day, the files will not be
  654. changed.  Also, using APPTEDIT to save data will only update APPT.DAT,
  655. APPT.BAK will be unchanged.
  656.  
  657.                    
  658.                    
  659.                    
  660.                    - 12 -
  661.      
  662. If you wish to run APPT at system start-up, you may include the command
  663. APPT.COM in your AUTOEXEC.BAT file (before interfacing utilities such as
  664. Microsoft Windows or menu programs).  This is a simple approach and
  665. requires that you place the APPT files in the root directory.  Placing the
  666. files in another subdirectory will require you to call APPT from a batch
  667. file, the path and name of which you would add to your AUTOEXEC.BAT file,
  668. or include the change directory (cd\) command in AUTOEXEC.BAT (yes, I know
  669. that AUTOEXEC a batch file <g>).  Consult your DOS manual for instructions 
  670. on creating batch files.  Also, APPT has never met DesqView.  If you wish
  671. to let them play together, I'd appreciate feedback.  Otherwise, it may be 
  672. best to keep them apart.
  673.  
  674. If your system does not keep time while power is off (i.e., you enter
  675. date/time at every start-up), the APPT command must be listed in your
  676. AUTOEXEC.BAT file after the TIME and DATE commands so that APPT will read
  677. the correct date from the system.  Even if you do not run APPT at start-up,
  678. you are obligated to at least enter the correct date if you wish to use
  679. APPT.
  680.  
  681. APPT.DAT may be assigned the System, Hidden, &/or Archive attributes, but
  682. not the Read-only attribute.  If you alter APPT.DAT's attributes, however,
  683. the new attributes will be valid only until you execute APPT.  This is so
  684. because when APPT modifies the data file (see above) it assigns read/write
  685. attributes.  
  686.  
  687.              ----------Errors----------
  688.  
  689. There are five (5) possible program-trapped errors that you could encounter
  690. while running APPT.  The generic error message reads:
  691.  
  692. ** ERROR **
  693. Please refer to APPT.DOC for clarification of the following:
  694.  
  695. and is followed by one of the errors below.
  696.  
  697. Incorrect DOS Version--APPT requires DOS 2.0 or higher.  
  698.      Some of APPT's interactions with DOS were not possible with earlier 
  699.     versions of DOS.
  700.  
  701. Error Opening Data File--Cannot find appointments.  
  702.      This occurs if APPT does not find the data file APPT.DAT for any of 
  703.     the following reasons:  
  704.       
  705.      -APPT.DAT does not exist on your disk.  
  706.      
  707.      -APPT.DAT exists, but resides in a directory other than the one in 
  708.         which APPT.COM resides.  
  709.      -The data file is named something other than APPT.DAT.
  710.  
  711.                   
  712.                   
  713.  
  714.  
  715.                    - 13 -
  716.  
  717.      Whichever the case, APPT will create the empty data file APPT.DAT, 
  718.      to which you should then add your appointments.  This error will also 
  719.      occur if the data file has been assigned a READ-ONLY attribute.  In 
  720.      this case, you must remove the READ-ONLY attribute with DOS' ATTRIB 
  721.      command (ATTRIB -R APPT.DAT).  If APPT returns an error under this 
  722.      condition, it will not create an empty data file as explained above.
  723.  
  724. Error Reading Data File--Check data file integrity.
  725.      This error should occur rarely, if ever; probably only if either file 
  726.      is damaged.  In such a case, your first approach should be to 
  727.      reconstruct your data file (first, try renaming APPT.BAK).  
  728.      
  729. Incompatible Video Adapter--APPT requires CGA or better.  
  730.      APPT will not run with a Monochrome Display Adapter (MDA).  Acceptable
  731.      adapters include CGA, EGA, VGA.
  732.  
  733. Error Writing Data File--Edits may not be saved.
  734.      This is an error that I've not seen occur, but decided to trap just the
  735.      same.  Again, this should only occur if either file is damaged.
  736.  
  737. This is the first release of APPT Appointment Minder.  I encourage you to
  738. offer feedback on APPT and this document regardless of the stage of your 
  739. evaluation or registered use.  I very much look forward to user input.  
  740.  
  741. I hope that APPT serves you well.  I am sorry, but phone support is
  742. presently unavailable for APPT.  You may contact me at any of the addresses
  743. below.  
  744.  
  745. CompuServe:     71172,266
  746.  
  747. RIME:           ->CAROUSEL
  748.       or    ->410
  749.  
  750. USPS:           James Corpening
  751.         GymusWhere?
  752.         828 NW 79 Terrace
  753.         Plantation, FL  33324
  754.  
  755.  
  756.                   
  757.  
  758.  
  759.                   
  760.                   
  761.                   
  762.                    
  763. IBM is a trademark of International Business Machines 
  764. DesqView is a trademark of Quarterdeck Office Systems
  765. Microsoft Windows is a trademark of Microsoft Corporation
  766.                    
  767.                    
  768.                    
  769.                    
  770.                    - 14 -
  771.                       
  772.               R E G I S T R A T I O N   F O R M
  773.                
  774.                -----------------------
  775.                    A P P T
  776.                -----------------------
  777.                  Appointment  Minder
  778.                 Version  1.01
  779.                     
  780.  
  781. Name:                   _______________________________
  782.      
  783. Company:                _______________________________
  784.  
  785. Address:                _______________________________
  786.  
  787.             _______________________________
  788.  
  789. City, State,  Zip:      _______________________________
  790.  
  791. Day Phone:              (_____)________________________
  792.  
  793. Today's Date:           ____/____/____
  794.  
  795. Where did you acquire APPT?________________________________________________
  796.  
  797. ___________________________________________________________________________
  798.  
  799. ____________________________  If BBS, Phone:(_____)__________________
  800.  
  801. Number of copies to register ______ x $10.00 per copy = $____________
  802.                                
  803.  
  804. Please make payment to James Corpening.
  805. Send a check or money order (US Dollars, US Bank) to:
  806.  
  807.     James Corpening
  808.     GymusWhere?
  809.     828 NW 79 Terrace
  810.     Plantation, FL  33324
  811.  
  812. Shortly after you register, you will receive instructions to eliminate 
  813. the shareware notice on your copy of APPT.
  814.  
  815. Thank you for your honesty.  Please recycle and don't litter.
  816.  
  817. Comments are very welcome: __________________________________________________
  818.  
  819. _____________________________________________________________________________
  820.  
  821. _____________________________________________________________________________
  822.  
  823. _____________________________________________________________________________
  824.                    
  825.                    - 15 -
  826.